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SECTION  1 
INTRODUCTION 


1.1  PURPOSE 

The  Short  system  Tape  Generator  ( SSTGEN )  is  a  utility 
program,  that  executes  on  the  AN/CTK-i2(v>  under  the  Progressing 
Support  System  <B)  Operating  system  (PSS/OS).  SSTGEN 
converts  compiler  object  decks  and  data  decks  into  a  system 
load  tape,  compatible  with  PLAN  IT  and  MADCAP  system  loading 
and  operation.  The  input  (object  and  data  decks)  may  be  from 
cards,  commercial  tape  or  disk  and  output  is  to  commercial 
tape,  Tape  Transport  Cartridge  (TTC)  or  punched  cards. 

1.2  REFERENCE  DOCUMENTS 

586000-906  PSS(B)  User  Manual,. 


USACSCS-TF-1-1/2-1 
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SECTION  2 

CONTROL  CARD  FORMATS 


The  purpose  of  the  control  cards  is  to. select  execution 
time  options,  the  output  iiedia,  the  input  nedia  and  file 
identification  and  other  control  directives.  The  control 
coaaands  recognized  by  SSTGEN  are  shown  in  Figure  2-1. 


COMMAND 

CLASS 

PARAGRAPH 
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OPTA 

OPTB 

OPTC 

OPTD 

options 

2.2 

z 

TEST 

TTC 

TAPE 

DECK 

output 
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*OBJ 
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*DATA 
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control 
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Figure  2-1.  SSTGEN  Control  card  coaaands 
2.1  GENERAL  CONTROL  CARD  RULES 

The  following  rules  are  applicable  to  SSTGEN  control  cards: 

a.  The  control  card  nust  begin  with  asterisk  <*)  in 
column  l,  followed  by  the  command, wi thout  any 
intervening  blanks. 

b.  The  operand  field  of  the  control  card  begins  in 
coluan  10  for  control  cards  requiring  parameters. 
Multiple  required  or  optional  paraieters  are 
separated  by  coaaas  with  no  intervening  blanks. 
Positional  parameters  aust  precede  keyword 
parameters . 
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c.  The  last  paraneter  oust  be  followed  by  at  least  one 
blank  colunn.  The  renainder  of  the  card  is 
available  for  user  connents. 

2.1.1  Positional  Paraneters 

Positional  paraneters  Bust  be  coded  first  in  the  operand 
field.  The  first  positional  paraneter  on  an  SSTGEN  control 
card  is  always  the  FILENAME,  the  second  positional  paraneter 
on  the  card  is  always  the  MEMBERNAME.  Absence  of  either 
positional  paraneter  is  indicated  by  a  conna  (a  null  field). 

mmii  * 

Col  col 

1  10 

*xxx  blank  in  col  10  indicates  blank  f ilenane .nenbernane 

* X X X  • . 10*22  blank  f  ilenane  .nenbernane  keyword  paraneter 

* X X X  TA PE • , VOL *9832  filenane  specified,  blank  nenbernane 

®xxx  TAPE  filenane  specified  blank  nenbernane 

* x x x  3ISK.FILEA  filenane.  nenbernane  specified 
!ixxx  disk , F1LEA  , ID*88  keyword  paraneter  used 

2.1.2  Keyword  Paraneters 

Keyword  paraneters  nay  be  placed  in  the  operand  field,  in  any 
order,  following  all  positional  paraneters.  The  absence  or 
default  value  of  a  keyword  paraneter  need  not  be  specified. 
Keyword  paraneters  are  in  the  forn  "KEYWORD«paraneter" .  The 
three  keyword  paraneters  recognized  by  SSTGEN  are  as 
f ol lows : 


a.  VOL.  Volune  serial  nunber  identifier!  this  allows 
a  particular  volune  to  be  specified  for  access, 
e.g..  VOL *98 32 .  If  an  anpersand  ( C )  precedes  the 
paraneter  (e.g.  CTAPEF ) »  the  volune  assignnent  is 
deferred  until  run-tine  when  it  is  assigned  by  the 
conputer  operator.  A  naxinun  6-character  paraneter 
is  pernitted  (including  the  anpersand).  By 
convention  the  serial  nunber  of  a  Tape  Transport 
Cartridge  ( TTC )  is  its  reel  nunber.  The  default 
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value  for  an  input  tape  is  CINPllT,  the 
default  value  for  an  output  tape  is  CLOAD. 

b .  VERS.  A  one  to  three  digit  version  identifier 
(i.e.  level  number)  for  an  SPS  disk  file.  The 
default  value  is  the  latest  version. 

c.  10.  Program  identifier:  A  one  to  four  digit 
hexadecimal  program  identifier  which  will  be 
converted  to  a  right  justified  32-bit  binary  number 
to  be  stored  in  the  program  at  address  0000  for 
kadcap  programs  and  at  address  0002  for  PLANIT 
programs  (see  *OPTD  description).  The  default  is 
that  no  program  identification  will  be  stored. 

2.2  OPTION  SELECTION 

Four  option  selection  control  cards  are  permitted.  If  they 
are  used  they  must  be  the  first  control  cards  input  to 
SSTGEN.  The  option  cards  and  their  effects  are  as  follows: 

a.  * 0 P T A  no  parameters.  The  *0 PTA  card  causes  local 
data  to  be  dumped  on  the  printer  for  up  to  10 
object  deck  errors,  with  analysis,  the  dump  can  be 
used  to  determine  the  cause  of  the  error. 

b.  -0PT9  no  parameters.  The  *OPTB  card  causes  an 
is/was  printout  of  the  program  addressed  affected 
by  each  patch  card,  see  figure  2-2. 


0005  3. 4, 5, 6, 7,8,9  HALF  WORD  PATCH  CARD 

0004  IS  03000  0003  (0600  0003)  WAS  03000  0000  (0600  0000) 
0006  IS  00004  0005  (0004  0005)  WAS  00000  0000  (0000  0000) 
0000  IS  00006  0007  (0006  0007)  WAS  00000  0000  (0000  0000) 
OCOA  IS  00010  0009  (0008  0009)  WAS  26284  4649  (4D44  4649) 
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Figure  2-2.  *OPTS  Printout  Sample 
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c .  *  C  P  T  C  no  parameters.  The  -  0  P  T  C  card  causes  type-l 
and  type-9  cards  to  be  printed  when  tney  are  read 
by  the  program.  This  option  may  be  useful  for 
diagnosing  errors.  Type-l  cards  are  always  printed 
at  the  end  of  the  jod  as  a  separate  report. 

d.  -  D  ?  T  D  no  parameters.  The  * o P T D  card  causes  the 
program  identifier,  if  present  to  be  stored  in 
location  0002.  the  standard  convention  for  PLANIT 
tapes.  Absence  of  this  control  card  causes  program 
ID  to  oe  stored  at  location  0000,  the  MADCAP 
convention. 

2.3  OUTPUT  SELECTION 

The  output  selection  card  is  any  one  of  4  cards  wnich 
specify  the  output  device.  The  output  selection  card  must  be 
the  first  control  card  input  to  SSTGEN  immediately  following 
any  -OPT-  control  cards.  The  output  selection  cards  and 
their  requirements  are  as  follows: 

a.  -TEST  no  parameters.  The  -TEST  control  card 
specifies  no  card  nor  tape  output  is  to  be 
generated.  It  is  useful  in  verifying  files  or 
diagnosing  problems  in  conjunction  with  the  option 
control  cards,  initially  it  causes  error  messages 
00  thru  li  to  be  printed  with  their  corresponding 
text,  processing  is  otherwise  identical  to  -DECK  or 
-TAPE  processing. 

b.  -TTC  FILENAME, ,V0l*999 
The  -TTC  control  card  specifies  output  to  a  Tape 
Transport  Cartridge  (TTC).  The  filename  is  a 
required  parameter,  the  volume  identifier  is 
optional.  Default  volume  selection  is  "ELOAD". 

1 1 A  H  Z  k&k  '■ 


col 

i 

10 

-  TTC 

MAD  ,  , 

-  TTC 

PLOAD 

C.  -TAPE  FILENAME , ,V0L*9283 

The  -tape  control  card  specifies  output  to 
commercial  tape.  The  filename  is  a  required 
parameter,  the  volume  identifier  is  optional. 
Default  vclume  selection  is  "CLOAD" . 
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col  1  1C 

"TAPE  CTKAD, ,VOL*012O 

-TAPE  CTPLASIT 

d .  " deck  no  parameters.  T r. e  *  n  E  C  K  control  card 

specifies  the  card  puncn  as  the  output  device. 

P.A  INPUT  SELECTION 

Incut  selection  cards  select  the  input  device,  volume  or 
version  and  f ilena«e,iiemberna>e  of  the  data  sets  to  be  used 
in  building  a  system  tape.  The  ordering  of  the  input 
selection  cards,  along  with  patch  cards,  determine  the 
contents  of  the  system  load  tape. 

2  .  <• .  1  Unit  Selection 

The  unit  selection  (card  reader,  tape  unit  or  disk  file)  is 
determined  by  the  contents  of  the  FILENAME  and  MEMBER  NAME 
fields  on  tne  following  control  cards: 

"BOOT 

"OBJ 

"OBJ  ,  S  K  N  N 
-DATA 


The  FILENAME  and  MEKBERNAKE  fields  are  used  to  determine  the 
device  type  as  follows: 

a.  filename  blank.  Source  data  is  cards  following  the 
control  card,  until  the  next  control  card  is 
encountered. 

b.  FILENAME  non-blank,  MEMBER  NAME  blank.  Source  data 
is  from  labeled  commercial  tape  with  filename 
specif  led  . 

c.  FILENAME  non-blank.  MEMBLRSAME  non-clank.  Source 
data  is  from  SPS  disk  with  the  FILENAME  and 

MEM  SEP.  NAME  specified. 
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2.4.2  Input  Data  Process  Selection 

Four  types  of  input  data  process  selection  cards  are 
available.  Three  of  these  cards  indicate  the  input  data  is 
an  object  deck  to  be  converted  to  a  Dootable  or  object 
format  on  tape.  The  fourth  indicates  the  input  is  a  data 
deck  to  oe  converted  to  data  format  on  tape.  The  control 
cards  anc  their  requirements  are  as  follows: 

a.  -BOOT  FILENAME, MEMBERS AME,V0L*7756,VERS*123 

Tne  -BOOT  control  card  specifies  the  input  data  is 
an  object  deck  to  be  converted  to  bootable  format 
on  tne  output  device. 

b.  -OBJ  FILENAME, ME M  E  E SN  AM  E ,  VO  L  *  7 75 6 ,  V  ER  S  *  1  2  3  ,  I  D  *  7  1 
The  - o b J  control  card  specifies  the  input  data  is 
an  object  deck  to  be  converted  to  loadable  object 
format  on  the  output  device. 

C .  -OBJ , NSNN  FILENAME, MEMBERNA ME, VOL  *  7 756 , V ER S  *  1 2  3 
The  -CBJ.NNNS  control  card  specifies  the  input  is 
an  object  deck  to  be  converted  to  loadable  object 
format  on  the  output  device,  snnn  is  replaced  by  a 
one  to  four  Ciqit  hexadecimal  address  which 
specifies  the  halfword  address  of  the  first 
instruction  word  to  be  written  on  the  output 
device.  N  N  S  N  may  be  thought  of  as  an  offset  to  the 
program.  The  first  nnnn  (OOCO  to  NNSN-2) 
instructions  of  the  program  will  be  thrown  away. 

d  .  - DATA  FILENAME, MEMBER N A ME, V0L*7756,VERS*100 

The  -data  control  card  specifies  the  input  is  a 
data  deck  to  be  converted  to  blank  suppressed, 
blocked  data  records  on  the  output  device.  Appendix 
C  gives  further  information  on  the  blank 
suppressed,  blocked  data  records. 

2.5  CONTROL  SELECTION 

Tr, ere  are  two  control  selection  cards  which  function  as 
follows: 

a.  -MADEOF  no  parameters.  The  -MADEOF  control  card 
.  causes  a  2C-word  record  of  all  ones  to  be  written 

on  the  output  device.  This  record  is  recognized  by 
MADCAP  and  PLANIT  as  an  End-of-File  indicator, 
indicating  there  are  no  more  loadable  program 
records  on  the  tape. 
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* END  no  parameters.  The  • :  E  N  D  card  is  the  last 
control  card  in  an  SSTGEN  jobstep  and  causes  the 
output  device  to  be  closed  and  the  summary  list  to 
be  printed. 
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SECTION  3 

PATCH  CARD  FORMATS 


3.1  GENERAL  FORMAT 

The  general  format  of  a  patch  or  set  of  patches  is: 

AAA A  PATCHES 

where  A  AAA  starts  in  column  1  and  is  replaced  by  a  l-thru  u- 
digit  hexadecimal  add r e s s,  i r.d ica t ing  where  the  data  on  the 
patch  card  is  to  be  stored.  This  address  may  exceed  the 
length  of  the  program  anc  the  highest  address  will  be  saved 
as  the  new  program  end  address.  The  address  is  followed  by 
one  a  r.d  only  one  blank,  then  by  zero  or  more  data  fields 
separated  by  commas.  The  last  data  field  is  terminated  by  a 
blank  or  by  the  end  of  the  card.  The  remainder  of  the  card 
alter  the  last  data  field  may  be  used  for  comments. 

Each,  data  field  specifies  one  halfword  (16  bits)  of  data. 

The  data  is  stored  in  sequential  halfwords.  If  the  data 
field  contains  from  one  to  four  hexadecimal  digits,  the 
digits  are  converted  to  a  r i ght -j us t i f ied  16-bit  binary 
number.  Leading  zeroes  are  allowed  but  are  not  required. 

3.2  INSTRUCTION  FORMAT 

If  the  data  field  contains  five  hexadecimal  digits,  they  are 
interpreted  in  OFMKS  instruction  format  where: 

0  *  First  3  tits  of  opcode  (legal  range:  0-7) 

P  «  Last  a  bits  of  opcode  (legal  range:  o-F ) 
m  *  Mode  field  (legal  range:  0-3) 

H  *  Accumulator  designator  (legal  range:  C-F) 

S  *  Incex  register  designator  (legal  range:  C-7) 

A  patch  data  field  containing  more  than  five  digits  is 
illegal. 

3.3  PELATIVE  ADDRESS  FORMAT 

A  patch  data  field  may  also  contain  a  dollar  sign  as  the 
first  character.  This  is  used  for  transfer  instructions  and 
instructions  that  fetch  data  from  program  literal  pools. 
These  instructions  use  relative  mode  addressing  (mode  2 ) 
which  means  that  the  daw  field  of  an  instruction  contains 
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not  the  address  of  the  operand  but  rather  the  distance  (in 
halfwords)  froit  the  instruction  to  its  operand  (sinus  two 
halfwords) . 

As  an  exarple,  the  patch  card 
04C0  30200 i $800 

causes  the  following  instruction  to  be  stored  at  location 
o*»oo  s 

30200  0  3FE 
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SECTION  4 
DECK  STRUCTURE 


The  structure  of  an  SSTGFN  jot  requires  the  use  of  PSS/OS 
jot  control  language  ( J c L )  cards,  SSTGFN  control  cards,  and 
patch  cards.  PSS/OS  JCL  cards  are  described  in  the  PSS/OS 
User  Manual.  Appendix  8  contains  several  typical  jobs  with 
explanations. 

The  following  simple  rules  are  to  clarify  the  location  of 
patch  cards  in  relationship  with  object  decks  and  input 
control  cards : 

a.  Tr.e  first  card  defines  the  process  and  source  of 
the  data.  It  must  be  one  of  the  following  types: 

-BOOT 

-OBJ 

-OBJ  ,  NNNK 

b.  If  the  input  is  from  cards,  the  object  decx  nust 
immediately  follow  the  -BOOT,  -Obj  or  -OBJ.NNNN 
card. 

c.  Next  coses  the  optional  patch  card  area  of  the 
deck.  The  patch  card  area  is  defined  as  all  the 
cards  until  a  card  containing  an  asterisk  <  -  >  ir. 
column  1  is  encountered,  within  this  space,  cards 
with  column  l  blank  or  containing  an  ampersand  will 
be  treated  as  comment  cards  and  simply  are  printed. 
Patch  cards  conforming  to  tne  Section  3  description 
are  the  only  other  cards  permitted  in  this  space. 
The  patch  cards  are  applied  to  the  program  in 
memory  as  they  are  encountered. 

d.  when  the  next  asterisk  <-)  card  is  encountered,  the 
program  currently  in  memory  is  written  on  the 
output  device . 

Figure  4-1  shews  an  example  of  this  deck  structure. 
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PATCH  DECK  FOR  FILEA 


OBJECT  OFCK  IS  Fll  EA 
ON  TAPE 


GOT  30  3 


586000-514 


SECTION  5 

INPUT  FILE  FORMATS 

SET  ten  is  set  up  to  accept  input  fror.  disk  or  tape  files  or 
directly  from  cards.  This  section  describes  tnese  formats 
or. *  restrictions. 

5.1  CARD  INPUT 

If  card  input  is  used  it  must  be  a  legal  ooject  deck  frcit 
the  compiler  or  a  data  deck.  If  the  :;DATA  card  is  used  and 
incut  is  cards,  then  a  data  card  containing  an  asterisk  ( - ) 
m  column  l  is  illegal,  as  it  marks  the  end  of  the  data 
deck,  if  such  a  data  card  is  requirec  then  the  decs  will 
first  have  to  oe  transferred  to  a  tape  or  disk  file. 

5.2  TAPE  0?  DISK  FILE  INPUT 

Data  will  oe  accepted  properly  from  a  disk  or  tape  file 
Llecked  from  i  to  10  logical  records  per  physical  record. 

The  logical  record  size  for  an  object  deck  is  20  words  (80 
characters).  The  logical  record  size  for  data  files  is  21 
( e?4  cnaracters  ) . 

These  file  formats  are  specifically  oriented  to  the  tape  and 
disk  librarian  programs  available  under  PSS/OS.  The  library 
types  used  are  OBJECT  for  object  decks,  and  SOURCE  for 
data  decks,  only  the  first  72  characters  of  a  data  card  are 
used  so  as  not  to  defeat  tne  trailing  blank  suppression 
feature  of  the  packed  format,  several  cha ra cter i s ti c s  of  tape 
and  disk  files  require  additional  consideration. 


5.2.1  Tape  Files 

Tape  files  should  be  generated  in  file  sequential  order  by  e 

the  program  LIBGEN.  This  allows  files  to  be  used  oy  sstgen 
sequentially  without  rewinding  the  tape.  If  both  ooject  and 


data 

same 

files  are  to 
tape  in  the 

be  used  they 
correct  order , 

should  be  generated 
for  example: 

on 

the 

a . 

Library 
order . 

AAAA, OBJECT  - 

contains  object  decks 

i  n 

b. 

L  i  o  r  a  r  y 

SBBB, SOURCE  - 

contains  data  decks 

in 

order 
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5.2.2  Disk  Files 

Normally  disk  files  will  be  generated  by  trie  program  SPSLIS. 
They  say  also  ce  generated  directly  by  the  compile  in  the 
case  of  oo;ect  decks.  Unlike  tape  files  there  is  no  ordering 
problems  with  files  on  disk.  SSTGEN  will  automatically  read 
the  latest  version  of  a  disk  file  unless  the  VERS  parameter 
is  specified  on  the  control  card. 
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SECTION  6 
OUTPUT  FORUMS 


- . 1  0  E  C  K  OUTPUT 

Tne  dec*  output  is  normally  only  useful  for  a  single  boot 
output.  The  output  for  a  boot  deck  is  the  normal  program  in 
L5CCIC  preceded  by  7-boot  words  also  in  EBCDIC. 

6.2  TTC  OUTPUT 

TTC  output  format  is  one  record  per  program.  Boot  records 
will  be  preceded  by  7-fcoot  bytes.  Data  files  will  be  written 
as  one  or  more  2  o  C  0  word  ASCII  records  with  tne  format 
described  in  Appendix  C. 

fc .  ■»  TAPE  OUTPUT 


6.3.1  IEt-pibu  Tape  Format 

T h e  output  for  commercial  tapes  written  op.  an  ibh-PEBU  are 
tne  safe  as  TTC  output  with  the  exception  of  boot  records 
wr.  ich  arc  preceded  by  7-boot  words  rather  than  boot  bytes. 

6  .  * ,  2  SPS  Tape  Format 

The  SPS  ,nas  a  restriction  on  the  sire  of  tape  records 
w r x 1 1 en,  1 1 a  1 1 1  ng  them  to  204H  worcs  per  record  maximum.  A 
single  program  jay  be  written  as  one  or  more  records  on 
taFe.  In  the  case  cf  a  bootable  program,  the  hardware  will 
ignore  any  inter-record  gaps  and  read  the  complete  program 
in.  in  the  case  of  object  programs  greater  than  20<.e  words, 
tne  loading  program  will  have  to  provide  the  additional 
processing  to  read  in  the  complete  program. 

k . 4  USTINCS 


T“e  first  part  of  the  listing  generated  by  SSTGEN  is  during 
tr.e  processme  of  the  input  job  stream.  Control  cards,  patch 
cards,an<*  error  messages  along  with  optional  selections 
<;C!»ta,  :  0  P  T  B  anc  =•=  c  P  T  C  )  are  printed  during  the  process, 
when  the  s:Psd  card  is  encountered,  a  Summary  Report  is 
printed  which  contains  the  type-i  cards  which  identify  the 
object  decus  utilized.  The  SSTGEN  control  cards  *DATA  and 
■:'i. A de OF  are  used  in  place  of  type-i  cards  in  this  report. 

V'e  summary  report  also  lists  the  following  items  for  each 
entry: 


6-1 


586000-914 


a.  RODS  -  The  count  of  type-0  cards  in  an  object  deck 
or  count  of  data  cards  in  a  data  deck. 

b.  ?TCH  -  The  count  of  patch  cards  applying  to  a 
particular  prog  ran. 

c.  A 3 R S  -  The  last  word  address  of  the  program  record. 
This  value  will  be  the  program  si2e  or  highest 
patch  address  if  greater  than  the  program  size. 

d.  BOOT  BYTES  -  If  the  program  is  bootable,  the  boot 
bytes  will  be  listed. 

following  the  last  type-1  card  (or  equivalent ), the  message 
**I  T  F  v  S  *  nnnn  ERRORS  *  eeee*is  printed.  The  items 
count  is  the  number  type-1  cards  (or  equivalent)  and  the 
error  count  is  the  number  of  errors.  The  item  and  error 
counts  would  normally  be  cheered  first  to  see  if  a  tape  was 
made  correctly. 
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APPENDIX  A 
ERROR  MESSAGES 


The  following  messages  will  be  output  fcy  S  S  T  G  E  N  when  errors 
are  detected,  messages  01  thru  1C  will  be  printed  with  the 
t  e  >  t  indicated  in  capital  letters.  Other  messages  will  be 
printed  with  the  caption  "ERROR.  SEE  USER  MANUAL*. 


ERROR  ££iC£I£Il£S 

01  SO  MODE  CARD.  SET  TO  TEST.  The  first  card  after 

any  option  cards  was  not  an  output  selection 
card. 

02  OUTPUT  FILE  ERR,  SET  TO  TEST.  Output  file 

description  not  correctly  accepted  by  PSS/OS.* 
verify  output  selection  card. 

C 3  CONTROL  CARD  ERPOR,  CARD  IGNORED.  Invalid 

control  card  or  invalid  field  on  control  card. 

04  INPUT  FILE  ERR.  FILE  IGNORED.  Output  file 

description  not  correctly  accepted  by  pss/os; 
verify  input  selection  card. 

C 5  NO  TYPE1  CARD,  DECK  IGNORED.  * 0 P T A  dump  if 

selected . 

06  NC  TYPE9  CARD.  DECK  IGNORED.  0 P T A  dump  if 

selected. 

07  OBJECT  DECK  NOT  IN  ORDER.  *OPTA  dump  if 

selected. 

08  OBJECT  CARD  CHECKSUM  ERROR.  *OPTA  dump  if 

selected. 

09  BAD  OBJECT  CARD,  DECK  IGNORED.  :;OPTA  duip  if 

selected,  card  was  other  than  type  o,  5,  6,  e 
or  9. 

10  PATCH  CARE  ERROR.  Address  was  greater  than  3FFF 

cr  otherwise  did  not  cosply  with  Section  3 
rules. 
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mmnm 

SSTGEK  program  entry  table  exceeded  99  entries 
(program  licit). 

Type-0  ADDRESS  ERROR .  Address  greater  than  3FFF . 
::  o  P  T  A  dump  if  selected. 

Input  tape  file  description  not  correctly 
accepted  Dy  PSS/OS.  verify  input  selection 
cards . 

Input  disk  file  description  not  correctly 
accepted  by  PSS/OS.  verify  input  selection 
cards . 

Illegal  10  value  found  in  ID.  parameter.  It 
should  be  a  i-to  4- digit  hexadecimal  number. 
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APPENDIX  B 
SAMPLE  JOBS 


This  appendix  contains  typical  standard  ]  o  b  decks  and 
various  (codifications  that  night  Le  nade  to  the  standard  jod 
decks  during  the  course  of  progran  development.  Each  figure 
includes  explanatory  notes. 


(  1  JOB 
— nPtLE 
l  (EXEC 

0ZMJ4H57 .HOFF, CL AS -A 

MAOOBJ,  SSTr.EN,UN!T*7,ACSS*REA0,  It>IS«*HR 

TPBUILO.NODUMP 

"me 

CCOLIM 

MAOOBJ  SSTCtN 

(  >EXEC 

SSTGEN 

•ttc 

LOAD, «V0L*C7T  C 

OUTPUT  TO  TTC 

*100T 

OBMOOBJ. MDFI02 

"TPtT "FAULT  ISOLATION - 

•OBJ 

ORMOOfiJ , MOF l 03 

CMU  FAULT  I SCLATI CN 

♦0BJ.7F6  MAOOBJ, MADCAP 

tudcap 

•BOOT 

MADOB J.UTSPACER 

UNIT  TEST  SPACER 

*OBJ 

MAOOBJ, PSMQF  104 

>SSB  RAM  FAULT  ISOLATION 

•OBJ 

MAOOBJ, M0CL01 .10*2110 

FIELD  SCHEDULER 

*08  J 

MAOOBJ, MA0SUP40, 10*3120 

‘MADCAP  SUPAO  PROCESSOR 

•OBJ 

MAOOBJ, PS MOCL03, 10*3190 

PSSB  SCHEDULER 

*TJtT3 

M AOOft  J , PS  MOC L04 , 1 0*2 1 90' 

-fssb — EXECUT IV  e - 

•OBJ 

MAOOBJ, MOFOOl, 10*20 

LOCAL  LOOP  TEST 

— •TtBJ - 

-MADOBJ.MOF002,  10*30  . . 

"CPtr'FAULT  detection  — 

•OBJ 

MAOOBJ, MOFOC3, 10*40 

MFM  FAULT  detection 

_ *ORJ - 

MADOBj.MpFOOS, I0*6C  - 

TU»MM~FAULT  DETECTION 

•  OBJ 

MAOOBJ , MDF006 , 10*70 

ACC  FAULT  detection 

*OBJ 

"MAOUB  J  ,  MOFO  07 , "10*90 

ETO  FAULT OFTECTTON - 

•OBJ 

MAOOBJ, MDFDOB.  10*90 

OPM  FAULT  DETECTION 

— »OBJ - 

MADOB J , MDF009 , 1 0*  BO  - 

‘ETP'FAULT  DETECTION - 

•OBJ 

MAOOBJ, MOF010,10*BO 

DOT  FAULT  DETECTION 

*OBJ 

"MAOOBJ, MOFOl 1 ,  ID* CO - 

‘VFHED  loop  test  — 

•OBJ 

MAOOBJ, M0F012 ,10*00 

FFMED  LOOP  TEST 

*08J 

maOO BJ, M  OF  0 1 3 1 ID*FO 

TroTTmop^TEn - 

•  OBJ 

MAOOBJ, M0F014,  10* FO 

PDC/FDC  LOOP  TEST 

*093 

"MA03BJ.M0F015, 10*100 

T1TFAULT  DETECTION - 

•OBJ 

MAOOBJ, MOF 103* 10*130 

ARMM  FAULT  1 SnL  ATJ  ON 

»OBJ 

MAOOBJ, M0FI06  ,  I0*1<,0 

TUC’FAULT  ISOLATION  ■■ 

•OBJ 

MADOB J,MDF107,in»150 

cTD  FAULT  ISOLATION 

*OBJ 

"MADOB J,  MDCI08 ,  10*  l  6"D 

"DPM  FATJL  T  TSO  LA  T I  ON - 

•OBJ 

MAOOBJ, MOF 109 , 1  0*173 

ELP  FAULT  ISOLATION 

~»OBJ 

MAOOBJ, MOFX04, 10-lFO 

HAM  DISTURB 
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Figure  B-i . 


Standard  MADCAP  Job  Deck 


( 1  of  Z) 
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•OBJ 
•OBJ  " 

•  OBJ 

MAOOBJ, MOFOO  2* 10*1  AO 

MADJ8  J, MDF003 » I D“l BO 
MADOBJ.PSMDF004, IP* ICO 

CPU  fault  DETECTION 

MCM  FAULT  detection 
pssr  pam  fault  detection 

*OBJ 

•OBJ 

•OBJ 

•OBJ 

*MAOEOP 

•BOOT 

~  MACOBJ, MOFD05  .TIWOO 
HAHQB J.P SM0FP21, 10*210 

M A  009  J,  PS  MOP  1 2 1 »  I  D*'260  ~ 
MAOOBJ, M0FI05 , 1D*2B0 

APMM,  'FAULT  DETECTION 

PSSB  CTS  fault  detection 

PSSB  CTS  FAULT  ISOLATION- 
ARMM  FAULT  ISOLATION 

M AD09J, CPUUT 

CPU  UNIT  TEST 

TBPOT 

MAD  DB  J,  ASHOT 

- rRMB- untt  teti - 

•BOOT 

MAOOBJ,  F. TOUT 

£  TO  UNIT  TEST 

•BOOT 

maoobj,  en>DT 

"ELF  "UNIT  "TEST - 

•  BOOT 

MAOOBJ, ACCUT 

ACC  UNIT  TEST 

OOT 

m  ado  aj , ddtot 

DOT-  UNTO  TEST - 

•  BOOT 

M ADOB J , VFMUT 

VFMEO  UNIT  TEST 

■BTTTT 

~R  A  DOB  J7B  DTJUT 

- 801T  UNIT  TEST - 

•  BOOT 

MAOOBJ, FMOUT 

FFMED  UNIT  TEST 

•  BOOT 

MAOOBJ, RAM UT 

RAM  UNIT  TEST 

_  • BOOT 

MAOOBJ, OPMUT 

OPM  UNIT- Tf?T 

•POOT 

MAnOBJ,CUMOUPE 

COMOU  PE  I  COPY  FIELD  TAPE! 

_-srnoY 

MAnoBJTtcCOT 

CCC  UNIT- TTST  TTrST  S'ETl 

•  BOOT 

MADOBJ.BCRT 

BERT  (BIT  ERROR  RATE  TESTI 

'•BOOT 

MAOOBJ, OMOUf 

OMD  UNIT  TEST 

•BOOT 

MAOOBJ,  10UUT 

IOU  UNIT  TEST 

(  I  END 


NOTE:  All  files,  including  SSTGEN,  are  located  on 
disk  data  sets. 
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t  1.103 _ 0ZAfUH95,  HOFF  ,  Cl  4  S»A,  TAPE_*_t 


t ) o  x  EC  TPBUILO.NnOUHP 
CA°n _ 


l  sstgsn 

OBJECT 

DECK 

FOR  SSIGEN* 

• 

OBJ  ECT 

DFCK 

FOR  SSTGEN 

• 

OBJECT 

teck 

FCR  SSTGEN 

• 

OBJECT 

DECK 

FOR  SSTGEN 

9  SSTGEN 

OBJECT  DEC< 

FOR  SSTGEN 

tf.DL  1 H 

i  iexec 

SSTGEN 

•OPTO 

SET  PLANIT 

ID  OPTION 

•TTC 

LOAD* » VOL  *666 

OUTPUT 

TC  TTC  S/N  66b 

♦BOOT 

POS, ,VOL*CPLN 

♦OBJ 

8AMCMECK, , 10*10 

•OBJ 

M  IOP  ,  ,  1  D=  2C 

•OBJ 

T  M  |f!P  •  •  10*21 

•OBJ 

PlANl T , , l D=  30 

•OBJ 

PLAN l,, ID*Al 

•OBJ 

PIAN2  ,,1D=42 

•OBJ 

PLAN3  ,,10  *43 

•OBJ 

PL AN4, , 10*44 

•OBJ 

PLAN5 ,, 10*45 

•OBJ 

PLAN6, ,10=46 

•OBJ 

•LAN7 , , in»47 

•OBJ 

PLANS ,, ID =46 

•OBJ 

FINAL,  ,I0  =  5P 

•OBJ 

START ,, 10=60 

•  MADECF 

•DATA 

CF ILF  91 

3  MCMU 

CARDS  F  RE 

•END 

<  j  end 

NOTE:  SSTGEN  is  a  card  deck.  All  the  other  files 
are  located  on  a  single  tape  volume. 
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Figure  B-2.  standard  PLANIT  Job  Deck 
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REMOVE  THE  FOLLOWING  CARO 


OBJ  MADOBJ .KDFDOl , 10=20 


LOCAL  LOO?  TEST 


OBJ  0BJDECK.HBMDFDC1  ,  ID«20 


DEVELOPMENT 


note:  The  above  are  the  changes  to  sake  a 

madcap  TTC  with  a  development  version  of 
MDFOCl  located  on  the  disk  data  set  OBJDECK. 
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ure  B-3.  Development  Program  from  Disk  for  madcap  ttc 
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REMOVE  THE  FOLLOWING  CARDS 


-C5J  PLAN4,  ,  ID  *44 

*  0  E  J  ?  L  A  N  5  ,  ,  I  D  ‘  4  5 


imi£i_mii_iii2_i£2iffim<i_£Am 


-OBJ  PLAN 4,  ,IC'44,V0L*EDEV  - '•=  DEVELOPMENT  *=.= 

::  0  E  J  PL  AN5  ,  ,  ID '45  ,  VOL  *  f.  PLK  (RETURN  TO  OSIG  TAPE) 


NOT?':  The  above  are  the  c  h  a  n  ;  e  s  to  sake  a 

PLAN  IT  TTC  with  a  development  version  of 
PLAN4  located  on  a  different  tape  volume. 
Especially  note  that  the  original  volute 
( E P L v l  lust  be  called  out  a  5  a  l  n  on  the 
plane  control  card. 
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Pigure  5-4.  Development  Program  From  Tape  For  PLANIT  TTC 
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REMOVE  THE  FOLLOWING  CARD 

I£££_IiLI_£lAli£Aii2_£A££.A£_m_a£££ 


-OEJ  MADOBJ,M0FDO2, ID*30  CPU  FAULT  DETECTION 


£I£AAiI_«IlA_m_£i2AAfiAl’i£_£AAfi£ 


::i  o  s  j  ,,io  or 

1  MDFDC.2 
0  I 


»•='•'  DEVELOPMENT  FD02  FROM  CARDS  * 

the  object  deck  for  MDFD02 


•  •  • 

9  MDFD02 


NOTE:  The  aoove  are  the  changes  to  Bake  a  MADCAP 
TTC  with  a  develop Bent  version  of  MDFD02 
in  card  deck  f  0  r  *  a  t . 
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igure  P-5.  Developrent  Program  From  Cards  For  madcap  TTC 
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Figure  5-6  shows  a  portion  of  the  jot  deck  as  it  eight 
appear  for  creating  a  released  MADCAP  TTC  with  patch  £COs 
to  MDF2C2,  MDFI03,  PSMDFI04  and  MDFD01.  Note  that  the 
library  paten  deck  used  tc  lake  the  TACFIPE  FIELD  TAPF  is 
acceptable  for  use  in  SSTGEN  job  decks  with  the  following 
exceptions : 

a .  k D  F I c  2  -  The  patches  requireo  oy  the  library  are 
offset  by  1 4 - r. a  1  f w 0 r d s  f  r  0  b  the  true  address  to 
accost  odate  boot  bytes. 


b.  MDF :  03  ar.  c  fsvdfioa  -  The  patches  required  by  the 
library  are  offset  by  fixed  constants  and  are 
located  in  the  INITIAL!  file. 

Equivalent  patch  decks  must  be  prepared  for  t  n  e  above 
•-  rotrars  using  the  true  address  as  snown  in  the  program 
listing. 


•  BOOT  OflMOOBJ,MOFI02_  "'  CBU_F4ULT'  ISOLATION 

EOU I V I  L*NT  TO  S-8883B  TO  MOFI02  599168-4253-001 

TrtSJTdTff  NO®  XFR  SW  ERROR  STOP  ”  - - 

2064  0,0  MOP  XFR  SW  E»R.1B  ST  JP 

2066  0,0  MOP  XFR  Sw  EOPOP  STOP 

2068  0,0  NOP  XFP  SW  ERROR  STOP 

~»obj  oBwnrmj,woFn3  ' — emu ‘fault  rs  out  ton - 

EOUIVILANT  TO  S- T7777  TO  MTF | 03  5991 93-4254-001 

urn "070 — NOP  port  ft  T  PST - 

•D«J,7F6  MADJBJ, MADCAP  MADCAP 

♦BOOT  MAOOBJ.tjTSPACER  "  “UNIT  TFSO  SPACER - 

•OBJ  MA0°3J,  PS  HOF 104  PSSB  RAM  FAULT  ISOLATION 

~  EOUIVILANT  TO  5—66666  TO  0S9OFI04  59»  3BI-423 1-00  I . . 

07AF  8333  CORRECT  TOANSFER  TO  A30RFSS 

-»nBi - MAros  j,  mtcloi  ,  10-21  to —  rTFlTrSCMEDUTFS! - 

•OBJ  MAPOtt J , MADSUP40 ,10*3120  MAOCAP  SUP40  PROCESSOR 

'••OBJ  *  M AOOB J, PS  M9CL  03,10*3180  PSSB  SCHEDULE®  - 

•OBJ  MAD03  J , PS  M0CL04 ,10*2190  PSSB  EXECUTIVE 

""•OBJ  MAOOB  J, MOFOO 1 , 1 0s  20  "LOCAL  LOO®  TFST  . . . . 

CCPGM-M0FD31  SAMPLE  S-49999  MO^OO!  595151-4253-001 

“0200  ‘30200, il06  COARFCT~XTA  - 5-99999  "MOROO I - 595  153-4?53*C0l 

0300  0,1,2, 3  RevrS®  TABLE  S—  99999  MOFool  599 1 53-425 3-001 

•  OBJ  MAOOBJ,M0F002,  10-30  - TPIT  FAULT  DETECTION 

•  •  • 


6C 1  3C-  10 


Figure  E-6.  MADCAP  Job  Deck  with  Patch  ECOs 
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APPENDIX  C 

UANK  SUPPRESSED,  BLOCKED  DATA  RECORDS 


This  appendix  describes  the  blank  suppressed,  blccxed  data 
record  format  generated  by  SSTGEN  anc  used  oy  PLANI?  for 
ascii  card  data  on  tape.  The  process  consists  of  dropping 
tre  trailing  blanks  from  a  72-column  card  image  and  packing 
the  truncated  card  image  in  2000-word  blocks  to  be  written 
on  tape.  Three  special  characters  are  also  packec  with  the 
data  for  control  purposes.  The  special  characters  are  as 
follows: 

a.  r C  (hexadecimal)  -  indicates  the  end  of  a  card 
1 rage . 

5.  FD  (hexadecimal)  -  indicates  the  end  of  a  physical 
tape  record  (no  more  card  data  in  this  record). 

c.  FE  (hexadecimal)  -  the  end-of-file  indicator  for 
the  entire  data  set.  This  is  not  to  be  confused 
with  nor  take  the  place  of  the  PLANIT  End-of-File 
indicator 


Figure  C-l  snows  portions  of  a  typical  source  deck  and  the 
resultant  packed  format. 
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amim.cAm 

!5DATn  (CARD  SOURCE  DATA  DECK) 
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Figure  C-l.  Typical  source  And  Packed  Data  Format 


